script organization

A hands-on guide to cleaning up shell scripts with AI and common CLIs: inventory and categorize with the vendor‑neutral llm, auto-generate headers/README, format with shfmt, lint via ShellCheck with AI explanations, detect and consolidate duplicates, and optionally build a semantic search index—keeping everything in Git with human-in-the-loop review, careful prompts, secret hygiene, and options for local models.